Contexto global

GetFileFromServerAsync

Variante de sintaxis: Con diálogo

Sintaxis:

GetFileFromServerAsync(<Dirección>, <NombreArchivo>, <ParámetrosDiálogoObtenciónArchivos>)

Parámetros:

Tipo: Cadena.
Colocación de datos en un almacenamiento temporal o en la base de datos.
El parámetro no puede ser una cadena vacía. De lo contrario, se genera un mensaje de error.

Tipo: Cadena.
El nombre de archivo que se ofrecerá al usuario para guardar el archivo. El usuario puede cambiar el nombre del archivo.
Valor predeterminado: Una cadena vacía.

Tipo: GetFilesDialogParameters.
La estructura que contiene los parámetros del cuadro de diálogo que se mostrará al usuario.

Descripción de la variante del método:

Recibe un archivo y lo guarda en el sistema de archivos local del usuario, solicitando al usuario que seleccione la ubicación del archivo recibido.

El resultado de la ejecución de la promesa se llena instantáneamente (en el cliente web, antes de que se muestre el diálogo, en otros clientes, después de que se muestre el diálogo) con Undefined.

El cliente web no requiere la extensión del sistema de archivos, pero la utiliza si ya está instalada. En el cliente web sin la extensión del sistema de archivos instalada, se ignoran las configuraciones del parámetro <ParámetrosDiálogoObtenciónArchivos>.
En los clientes ligeros y gruesos, aparece un cuadro de diálogo donde se puede especificar qué hacer con el archivo recibido, si abrirlo o guardarlo en el directorio seleccionado. Si no se especifica el parámetro <NombreArchivo>, la operación de apertura de archivo no está disponible. Al abrir el archivo recibido, se verifica la aplicación asociada con el tipo de archivo. La verificación se realiza por la extensión del archivo. Si no se encuentra una aplicación adecuada, se muestra el cuadro de diálogo del sistema para seleccionar una aplicación para abrir el archivo. Después de elegir la aplicación, el archivo se abre en ella. Si no elige una aplicación, se cancela la apertura del archivo.
En la plataforma móvil, no se muestra el cuadro de diálogo para seleccionar un archivo.

Variante de sintaxis: Sin diálogo

Sintaxis:

GetFileFromServerAsync(<Dirección>, <RutaArchivo>)

Parámetros:

Tipo: Cadena.
Colocación de datos en un almacenamiento temporal o en la base de datos.
El parámetro no puede ser una cadena vacía. De lo contrario, se genera un mensaje de error.

Tipo: Cadena.
Ruta de acceso a un archivo para guardar el archivo.

Descripción de la variante del método:

Recibe un archivo y lo guarda en el sistema de archivos local del usuario mediante la ruta especificada. En este caso, el usuario no puede cambiar la ubicación del archivo recibido.

El resultado de la promesa es un objeto del tipo TransferredFileDescription.

La extensión del sistema de archivos es requerida en el cliente web.

Valor devuelto:

Tipo: Promise.

Descripción:

Función asíncrona. Obtiene un archivo.

Disponibilidad:

Cliente ligero, cliente web, cliente móvil, cliente grueso, aplicación móvil (cliente).

Consulte también:

Contexto global, método BeginGetFileFromServer
Contexto global, método GetFile

Disponible desde:

Disponible desde la versión 8.3.18.